

    \filetitle{plotmat}{Visualise 2D matrix}{grfun/plotmat}

	\paragraph{Syntax}

\begin{verbatim}
[HPos,HNeg,HNanInf,HMax] = grfun.plotmat(X,...)
[HPos,HNeg,HNanInf,HMax] = plotmat(X,...)
\end{verbatim}

\paragraph{Input arguments}

\begin{itemize}
\tightlist
\item
  \texttt{X} {[} numeric {]} - 2D matrix that will be visualised; ND
  matrices will be unfolded in 2nd dimension before plotting.
\end{itemize}

\paragraph{Output arguments}

\begin{itemize}
\item
  \texttt{HPos} {[} numeric {]} - Handles to discs displaying
  non-negative entries.
\item
  \texttt{HNeg} {[} numeric {]} - Handles to discs displeying negative
  entries.
\item
  \texttt{HNanInf} {[} numeric {]} - Handles to NaN or Inf marks.
\item
  \texttt{HMax} {[} numeric {]} - Handles to circles displaying maximum
  value.
\end{itemize}

\paragraph{Options}

\begin{itemize}
\item
  \texttt{\textquotesingle{}colNames=\textquotesingle{}} {[} char
  \textbar{} cellstr \textbar{} empty \textbar{}
  \emph{\texttt{\textquotesingle{}auto\textquotesingle{}}} {]} - Names
  that will be given to the columns of the matrix.
\item
  \texttt{\textquotesingle{}rowNames=\textquotesingle{}} {[} char
  \textbar{} cellstr \textbar{} empty \textbar{}
  \emph{\texttt{\textquotesingle{}auto\textquotesingle{}}} {]} - Names
  that will be give to the row of the matrix.
\item
  \texttt{\textquotesingle{}maxCircle=\textquotesingle{}} {[}
  \texttt{true} \textbar{} \emph{\texttt{false}} {]} - If
  \texttt{true},display a circle denoting the maximum value around each
  entry.
\item
  \texttt{\textquotesingle{}nanInf=\textquotesingle{}} {[} char
  \textbar{} \texttt{X} {]} - Appearance of \texttt{NaN} and
  \texttt{Inf} entries.
\item
  \texttt{\textquotesingle{}showDiag=\textquotesingle{}} {[}
  \emph{\texttt{true}} \textbar{} \texttt{false} {]} - If
  \texttt{false}, hide the entries on the main diagonal by setting them
  to \texttt{NaN}.
\item
  \texttt{\textquotesingle{}scale=\textquotesingle{}} {[} numeric
  \textbar{} \emph{\texttt{\textquotesingle{}auto\textquotesingle{}}}
  {]} - Maximum value (positive) relative to which all matrix entries
  will be scaled; by default the scale is the maximum entry in the input
  matrix, \texttt{max(max(abs(X(isfinite(X))))}.
\end{itemize}

\paragraph{Description}

\paragraph{Example}


